package com.fish.service;

import com.fish.model.vo.FileInfoVO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

/**
 * 文件上传服务接口
 */
public interface FileUploadService {
    
    /**
     * 上传文件
     * 
     * @param file 文件
     * @param path 存储路径（可选）
     * @param storageType 存储类型（minio/local/oss）
     * @return 文件信息
     */
    FileInfoVO upload(MultipartFile file, String path, String storageType);
    
    /**
     * 批量上传文件
     * 
     * @param files 文件列表
     * @param path 存储路径（可选）
     * @param storageType 存储类型
     * @return 文件信息列表
     */
    List<FileInfoVO> batchUpload(List<MultipartFile> files, String path, String storageType);
    
    /**
     * 删除文件
     * 
     * @param fileId 文件ID
     * @return 是否删除成功
     */
    boolean delete(Long fileId);
    
    /**
     * 根据ID获取文件信息
     * 
     * @param fileId 文件ID
     * @return 文件信息
     */
    FileInfoVO getFileInfo(Long fileId);
    
    /**
     * 获取用户上传的文件列表
     * 
     * @param userId 用户ID
     * @return 文件列表
     */
    List<FileInfoVO> getUserFiles(Long userId);
}
